MYZR-IMX6-EK140P 使用及开发指导
===============================

本文档使用说明
---------------

- 项目中 **所有参与人员** 需要了解 **"第五部分 其它必要的文档"**
- 项目中 **所有需要使用开发板的人员** 需要了解并操作 **"第一部分 开发板使用快速入门"**
- 项目中 **软件开发工程师** （包括BSP工程师、应用软件工程师）需要了解并完成 **"第二部分 软件开发基本指导"**
- 项目中 **BSP开发工程师** 需要了解 **"第三部分 软件开发进阶指导"**
- 项目中 **硬件开发工程师** 需要阅读 **"第四部分 硬件开发指导"**

手册链接
~~~~~~~~~

| **测试手册**：
  :doc:`《Linux-4.1.15》<MYZR-IMX6-EK140P Linux-4.1.15 测试手册>`
  :doc:`《Linux-4.9.88》<MYZR-IMX6-EK140P Linux-4.9.88 测试手册>`

| **开发环境指导手册**：
  :doc:`《Ubuntu14.04+Win10 (推荐)》</docs/COMMON/MYZR Windows-10 VirtualBox-5.2.12 Ubuntu-14.04.5 64位开发环境指导>`
  :doc:`《Ubuntu12.04+Win10》</docs/COMMON/MYZR Windows-10 VirtualBox-5.1.18 Ubuntu-12.04.5 64位开发环境指导>`
  :doc:`《Ubuntu12.04+Win7》</docs/COMMON/MYZR Windows-7 VirtualBox-4.3.40 Ubutnu-12.04.5 64位开发环境指导>`

| **编译手册**：
  :doc:`《Linux-4.1.15》<MYZR-IMX6 Linux-4.1.15 编译参考手册>`
  :doc:`《Linux-4.9.88》<MYZR-IMX Linux-4.9.88 编译参考手册>`

| **驱动和设备手册**：
  :doc:`《Linux-4.1.15》</docs/MYZR-iMX6系列/MYZR-IMX6-EK140/MYZR-IMX6-EK140 L40115 驱动和设备>`
  :doc:`《Linux-4.9.88》</docs/MYZR-iMX6系列/MYZR-IMX6-EK140/MYZR-IMX6-EK140 L40988 驱动和设备>`

其它说明
~~~~~~~~~

- 文档内所有链接的打开，建议使用鼠标右击 **在新标签中打开**。
- **MYZR-IMX6-EK200、MYZR-IMX6-EK314、MYZR-IMX6-EK336** 建议使用的内核版本是 **Linux-3.14.52**。
- **MYZR-IMX6-EK140、MYZR-IMX6-EK140P** 建议使用的内核版本是 **Linux-4.1.15**。

第一部分 开发板使用快速入门
---------------------------

**这部分内容和操作，首次阅读和完成大概需要半天的时间**

1. 拿到开发板后，第一件事是为使用开发板做准备，安装终端软件是必要的。打开 :doc:`《终端软件参考手册》</docs/COMMON/Xshell.RM.参考手册>` ，参照 软件下载及安装 把终端软件安装好。
2. 终端软件安装好之后，打开 :doc:`《启动手册》<MYZR-IMX6-EK140P 启动手册>` ，参照文档启动开发板。
3. 开发板启动成功后，参照 :doc:`《烧录指导手册》<MYZR-IMX6 MfgTool-v2.6 User Guide>` 进行一次烧录。目的是熟悉烧录操作以及准备下一步的功能验证。
4. 开发板烧录完成后，打开对应的 **【测试手册】** 进行一遍测试以验证开发板各项功能正常。

第二部分 软件开发基本指导
-----------------------------

**这部分内容和操作，首次阅读和完成大概需要半天的时间**

1. 首先， 要进行软件开发，需要建立开发环境，在搭建嵌入式开发环境的时候会遇到各种各样的问题，为了避免浪费不必要的时间和精力，这里我们推荐使用我们的虚拟机环境。打开 **【开发环境指导手册】**，参照文档把虚拟机配置好。
2. 开发环境建立好之后，应参照 **【编译手册】** 进行一次编译，并保留编译得到的目标文件。
3. 编译好目标文件之后，更新目标文件到设备，并最好参照 **【测试手册】** 再进行一次测试，以验证编译出来的目标文件没有问题。

第三部分 软件开发进阶指导
-------------------------

|   在完成 **开发板使用快速入门** 和 **软件开发基本指导** 后，基本的东西我们都已经熟悉了。那么，下一步，便是二次开发需要了解的内容了。

U-Boot 板级文件
~~~~~~~~~~~~~~~~

1. u-boot 板级文件位置：board/myzr
2. u-boot 板级配置文件：include/configs/myimx*.h
3. u-boot 极级编译配置文件：configs/<ek_name>-<cpu_type>-<mem_size>-\*_defconfig

Linux 内核板级文件
~~~~~~~~~~~~~~~~~~~

1. 内核板级编译配置文件：arch/arm/configs/myimx*_defconfig
2. 内核板级设备树文件：arch/arm/boot/dts/<ek_name>-<cpu_type>-<mem_size>-\*
3. 内核开发参考手册：网盘中《i.MX_Linux_Reference_Manual.pdf》

第四部分 硬件开发指导
---------------------

1. 首先，硬件工程师有必要了解我们开发板底板的介绍和基本原理，具体见 :doc:`《底板硬件介绍》<MYZR-IMX6-MB140P 硬件介绍>` 。
2. 硬件工程师打开网盘，下载硬件原理图文件进行参考，或基于我们的原理图进行设计。
3. 如果某些接口和功能需要变更，可以参考 :doc:`《核心板硬件介绍》</docs/MYZR-iMX6系列/MYZR-IMX6-EK140/MYZR-IMX6-CB140 硬件介绍>` 里的 管脚定义&详细功能说明。更多详细信息请参照网盘中的"1.1_NXP-Document -> reference-manual"

第五部分 其它必要的文档
-----------------------

**i.MX Family Comparison Table**

- 所在网盘位置："1.1_NXP-Document -> brochure"

    **文档只有一页内容，建议所有参与项目的人员都阅读。**

**i.MX Applications Processors Fact Sheet**

- 所在网盘位置："1.1_NXP-Document -> fact-sheet"

    **对应的文档只有两页内容，建议所有参与项目的人员都阅读。**

**i.MX Applications Processor Reference Manual**

- 所在网盘位置："1.1_NXP-Document -> reference-manual"

    **对应的文档有多至六千页的内容，软件、硬件工程师可以在设计和开发的过程中选择性的阅读。**

**i.MX Applications Processor Technical Data**

- 所在网盘位置："1.1_NXP-Document -> technical-data"

    **对应的文档有约两百页的内容，软件、硬件工程师可以浏览并自行决定是否详细阅读。**